package com.cg.service;

import com.cg.entity.Region;
import java.util.List;

/**
 * 地区服务接口
 */
public interface RegionService {
    
    /**
     * 获取所有省份
     * @return 省份列表
     */
    List<Region> getProvinces();
    
    /**
     * 根据省份代码获取城市列表
     * @param provinceCode 省份代码
     * @return 城市列表
     */
    List<Region> getCitiesByProvince(String provinceCode);
    
    /**
     * 根据城市代码获取区县列表
     * @param cityCode 城市代码
     * @return 区县列表
     */
    List<Region> getDistrictsByCity(String cityCode);
    
    /**
     * 根据地区代码获取地区信息
     * @param code 地区代码
     * @return 地区信息
     */
    Region getByCode(String code);
    
    /**
     * 根据名称搜索地区
     * @param name 地区名称
     * @return 地区列表
     */
    List<Region> searchByName(String name);
}
